Contexto global
Formato
Disponible desde la versión 8.0.
Sintaxis:
Formato(<Valor>, <CadenaDeFormato>)
Parámetros:
<Valor> (obligatorio)
Tipo: Número, Fecha, Booleano.
Valor formateado.
<CadenaDeFormato> (opcional)
Tipo: Cadena.
Una cadena de formato es un valor de cadena que contiene los parámetros de formato. Los parámetros de formato se separan con el carácter “;”. Si se especifica este parámetro, significa que el formato no es estándar. Si no se especifica un formato estándar, se utiliza el formato estándar.
Si no se establece un parámetro, se utiliza el formato estándar (que generalmente funciona como la conversión del valor a cadena). Sin embargo, para los valores de tipo Número y Fecha, se devolverá una cadena vacía de forma predeterminada (0 y 01.01.0001 00:00:00 respectivamente).
Para establecer cada parámetro, debe escribir el nombre del parámetro, el símbolo “=” y el valor del parámetro. Puede especificar el valor del parámetro entre comillas o comillas dobles. Es necesario cuando el valor del parámetro contiene símbolos utilizados en la sintaxis de la cadena de formato o espacios. Puede especificar símbolos arbitrarios dentro del valor del parámetro. Cuando se forma la cadena resultante, estos símbolos se mostrarán “tal cual”. De esta manera, puede especificar los separadores de hora, minuto y segundo para el formato de hora. Si estos símbolos son iguales a los valores de la cadena de formato, debe colocarlos entre comillas simples.
Nombres y valores de los parámetros de la cadena de formato:
- L – pares de idioma/país que definen las reglas de formato. Pares de idioma/país disponibles:
- af Afrikáans
- af_NA Afrikáans (Namibia)
- af_ZA Afrikáans (Sudáfrica)
- am Amárico
- am_ET Amárico (Etiopía)
- ar Árabe
- ar_AE Árabe (Emiratos Árabes Unidos)
- ar_BH Árabe (Baréin)
- ar_DZ Árabe (Argelia)
- ar_EG Árabe (Egipto)
- ar_IQ Árabe (Irak)
- ar_JO Árabe (Jordania)
- ar_KW Árabe (Kuwait)
- ar_LB Árabe (Líbano)
- ar_LY Árabe (Libia)
- ar_MA Árabe (Marruecos)
- ar_OM Árabe (Omán)
- ar_QA Árabe (Catar)
- ar_SA Árabe (Arabia Saudita)
- ar_SD Árabe (Sudán)
- ar_SY Árabe (Siria)
- ar_TN Árabe (Túnez)
- ar_YE Árabe (Yemen)
- as Asamés
- as_IN Asamés (India)
- az Azerbaiyano
- az_AZ Azerbaiyano (Azerbaiyán)
- az_Cyrl Azerbaiyano (Cirílico)
- az_Cyrl_AZ Azerbaiyano (Cirílico, Azerbaiyán)
- az_Latn Azerbaiyano (Latino)
- az_Latn_AZ Azerbaiyano (Latino, Azerbaiyán)
- be Bielorruso
- be_BY Bielorruso (Bielorrusia)
- bg Búlgaro
- bg_BG Búlgaro (Bulgaria)
- bn Bengalí
- bn_IN Bengalí (India)
- ca Catalán
- ca_ES Catalán (España)
- cs Checo
- cs_CZ Checo (República Checa)
- cy Galés
- cy_GB Galés (Reino Unido)
- da Danés
- da_DK Danés (Dinamarca)
- de Alemán
- de_AT Alemán (Austria)
- de_BE Alemán (Bélgica)
- de_CH Alemán (Suiza)
- de_DE Alemán (Alemania)
- de_LI Alemán (Liechtenstein)
- de_LU Alemán (Luxemburgo)
- el Griego
- el_CY Griego (Chipre)
- el_GR Griego (Grecia)
- en Inglés
- en_AU Inglés (Australia)
- en_BE Inglés (Bélgica)
- en_BW Inglés (Botsuana)
- en_BZ Inglés (Belice)
- en_CA Inglés (Canadá)
- en_GB Inglés (Reino Unido)
- en_HK Inglés (Hong Kong, China)
- en_IE Inglés (Irlanda)
- en_IN Inglés (India)
- en_JM Inglés (Jamaica)
- en_MH Inglés (Islas Marshall)
- en_MT Inglés (Malta)
- en_NA Inglés (Namibia)
- en_NZ Inglés (Nueva Zelanda)
- en_PH Inglés (Filipinas)
- en_PK Inglés (Pakistán)
- en_SG Inglés (Singapur)
- en_TT Inglés (Trinidad y Tobago)
- en_US Inglés (Estados Unidos)
- en_VI Inglés (Islas Vírgenes de los Estados Unidos)
- en_ZA Inglés (Sudáfrica)
- en_ZW Inglés (Zimbabue)
- es Español
- es_AR Español (Argentina)
- es_BO Español (Bolivia)
- es_CL Español (Chile)
- es_CO Español (Colombia)
- es_CR Español (Costa Rica)
- es_DO Español (República Dominicana)
- es_EC Español (Ecuador)
- es_ES Español (España)
- es_GT Español (Guatemala)
- es_HN Español (Honduras)
- es_MX Español (México)
- es_NI Español (Nicaragua)
- es_PA Español (Panamá)
- es_PE Español (Perú)
- es_PR Español (Puerto Rico)
- es_PY Español (Paraguay)
- es_SV Español (El Salvador)
- es_US Español (Estados Unidos)
- es_UY Español (Uruguay)
- es_VE Español (Venezuela)
- et Estonio
- et_EE Estonio (Estonia)
- eu Vasco
- eu_ES Vasco (España)
- fa Persa
- fa_AF Persa (Afganistán)
- fa_IR Persa (Irán)
- fi Finlandés
- fi_FI Finlandés (Finlandia)
- fo Feroés
- fo_FO Feroés (Islas Feroe)
- fr Francés
- fr_BE Francés (Bélgica)
- fr_CA Francés (Canadá)
- fr_CH Francés (Suiza)
- fr_FR Francés (Francia)
- fr_LU Francés (Luxemburgo)
- fr_MC Francés (Mónaco)
- fr_SN Francés (Senegal)
- ga Irlandés
- ga_IE Irlandés (Irlanda)
- gl Gallego
- gl_ES Gallego (España)
- gu Guyaratí
- gu_IN Guyaratí (India)
- he Hebreo
- he_IL Hebreo (Israel)
- hi Hindi
- hi_IN Hindi (India)
- hr Croata
- hr_HR Croata (Croacia)
- hu Húngaro
- hu_HU Húngaro (Hungría)
- hy Armenio
- hy_AM Armenio (Armenia)
- hy_AM_REVISED Armenio (Armenia, Ortografía Revisada)
- id Indonesio
- id_ID Indonesio (Indonesia)
- is Islandés
- is_IS Islandés (Islandia)
- it Italiano
- it_CH Italiano (Suiza)
- it_IT Italiano (Italia)
- ja Japonés
- ja_JP Japonés (Japón)
- ka Georgiano
- ka_GE Georgiano (Georgia)
- kk Kazajo
- kk_KZ Kazajo (Kazajistán)
- kl Groenlandés
- kl_GL Groenlandés (Groenlandia)
- kn Canarés
- kn_IN Canarés (India)
- ko Coreano
- ko_KR Coreano (Corea del Sur)
- kok Konkani
- kok_IN Konkani (India)
- ky Kirguís
- ky_KY Kirguís (Kirguistán)
- lt Lituano
- lt_LT Lituano (Lituania)
- lv Letón
- lv_LV Letón (Letonia)
- mk Macedonio
- mk_MK Macedonio (Macedonia)
- ml Malayalam
- ml_IN Malayalam (India)
- mr Maratí
- mr_IN Maratí (India)
- ms Malayo
- ms_BN Malayo (Brunéi)
- ms_MY Malayo (Malasia)
- mt Maltés
- mt_MT Maltés (Malta)
- nb Noruego Bokmal
- nb_NO Noruego Bokmal (Noruega)
- nl Neerlandés
- nl_BE Neerlandés (Bélgica)
- nl_NL Neerlandés (Países Bajos)
- nn Noruego Nynorsk
- nn_NO Noruego Nynorsk (Noruega)
- om Oromo
- om_ET Oromo (Etiopía)
- om_KE Oromo (Kenia)
- or Oriya
- or_IN Oriya (India)
- pa Punyabí
- pa_IN Punyabí (India)
- pl Polaco
- pl_PL Polaco (Polonia)
- ps Pastún
- ps_AF Pastún (Afganistán)
- pt Portugués
- pt_BR Portugués (Brasil)
- pt_PT Portugués (Portugal)
- ro Rumano
- ro_RO Rumano (Rumania)
- ru Ruso
- ru_RU Ruso (Rusia)
- ru_UA Ruso (Ucrania)
- sk Eslovaco
- sk_SK Eslovaco (Eslovaquia)
- sl Esloveno
- sl_SI Esloveno (Eslovenia)
- so Somalí
- so_DJ Somalí (Yibuti)
- so_ET Somalí (Etiopía)
- so_KE Somalí (Kenia)
- so_SO Somalí (Somalia)
- sq Albanés
- sq_AL Albanés (Albania)
- sr Serbio
- sr_BA Serbio (Bosnia y Herzegovina)
- sr_CS Serbio (Serbia y Montenegro)
- sr_Cyrl Serbio (Cirílico)
- sr_Cyrl_BA Serbio (Cirílico, Bosnia y Herzegovina)
- sr_Cyrl_CS Serbio (Cirílico, Serbia y Montenegro)
- sr_Cyrl_ME Serbio (Cirílico, Montenegro)
- sr_Cyrl_RS Serbio (Cirílico, Serbia)
- sr_Latn Serbio (Latino)
- sr_Latn_BA Serbio (Latino, Bosnia y Herzegovina)
- sr_Latn_CS Serbio (Latino, Serbia y Montenegro)
- sr_Latn_ME Serbio (Latino, Montenegro)
- sr_Latn_RS Serbio (Latino, Serbia)
- sr_ME Serbio (Montenegro)
- sr_RS Serbio (Serbia)
- sv Sueco
- sv_FI Sueco (Finlandia)
- sv_SE Sueco (Suecia)
- sw Suajili
- sw_KE Suajili (Kenia)
- sw_TZ Suajili (Tanzania)
- ta Tamil
- ta_IN Tamil (India)
- te Telugu
- te_IN Telugu (India)
- th Tailandés
- th_TH Tailandés (Tailandia)
- ti Tigrinya
- ti_ER Tigrinya (Eritrea)
- ti_ET Tigrinya (Etiopía)
- tr Turco
- tr_TR Turco (Turquía)
- uk Ucraniano
- uk_UA Ucraniano (Ucrania)
- ur Urdu
- ur_PK Urdu (Pakistán)
- uz Uzbeko
- uz_Cyrl Uzbeko (Cirílico)
- uz_Cyrl_UZ Uzbeko (Cirílico, Uzbekistán)
- uz_Latn Uzbeko (Latino)
- uz_Latn_UZ Uzbeko (Latino, Uzbekistán)
- uz_UZ Uzbeko (Uzbekistán)
- vi Vietnamita
- vi_VN Vietnamita (Vietnam)
- zh Chino
- zh_CN Chino (China)
- zh_Hans Chino (Han Simplificado)
- zh_Hans_CN Chino (Han Simplificado, China)
- zh_Hans_SG Chino (Han Simplificado, Singapur)
- zh_Hant Chino (Han Tradicional)
- zh_Hant_HK Chino (Han Tradicional, Hong Kong, China)
- zh_Hant_MO Chino (Han Tradicional, Macao, China)
- zh_Hant_TW Chino (Han Tradicional, Taiwán)
- zh_HK Chino (Hong Kong, China)
- zh_MO Chino (Macao, China)
- zh_SG Chino (Singapur)
- zh_TW Chino (Taiwán)
- ND – el número total de dígitos decimales mostrados (en las partes entera y fraccionaria). El número fuente se redondea utilizando la opción Round15as20. Si se especifica este parámetro, se requiere el parámetro NFD (de lo contrario, no se mostrarán los dígitos fraccionarios).
- NFD – el número de dígitos decimales en la parte fraccionaria. El número fuente se redondea utilizando la opción Round15as20.
- NS – el desplazamiento de dígitos: positivo para la división, negativo para la multiplicación. El número fuente se multiplica o divide por 10*C, donde C es el valor absoluto de este parámetro.
- NDS – el separador de las partes entera y fraccionaria.
- NGS – el separador de grupos en la parte entera de un número. Si especifica una cadena en blanco, se utiliza un espacio no separable como separador.
- NZ – la presentación de cadena de un número cero. Si no se especifica, la presentación de un número cero es una cadena en blanco. Si se especifica “NZ=”, la presentación de un número cero es 0. No se aplica a campos de entrada numérica.
- NLZ – Bandera para mostrar ceros iniciales. Si no se especifica, se representa como una cadena en blanco. Este parámetro se ignora.
- NG – el enfoque para agrupar los dígitos de un número. El formato del valor es una lista de números separados por comas que define el número de posiciones agrupadas de derecha a izquierda. Solo los dos primeros números son significativos. El primer número define el agrupamiento inicial, que se aplica a los dígitos menos significativos de la parte entera. Si no se especifica el segundo número, solo se agrupan los dígitos menos significativos. Si el segundo número es 0, se aplica el agrupamiento inicial a todos los dígitos de la parte entera del número. Si el segundo número no es 0, se utilizará este valor para agrupar todos los dígitos que no sean los menos significativos ya agrupados.
- NN – la presentación de números negativos.
- 0 – una cadena del tipo ” (1.1)”;
- 1 – una cadena del tipo ” “-1.1”;
- 2 – una cadena del tipo “-1.1”;
- 3 – una cadena del tipo “1.1-“;
- 4 – una cadena del tipo “1.1 -“.
- DF – el formato de fecha.
- d – la fecha (dígitos) sin cero inicial;
- dd – la fecha (dígitos) con cero inicial;
- ddd – la abreviatura del día de la semana *);
- dddd – el nombre completo del día de la semana *);
- m – número de mes (dígitos) sin cero inicial;
- MM – número de mes (dígitos) con cero inicial;
- MMM – la abreviatura del mes *);
- MMMM – el nombre completo del mes *);
- q – número de trimestre;
- y – número de año sin siglo y sin cero inicial;
- yy – número de año sin siglo y con cero inicial;
- yyyy – número de año con siglo;
- h – las horas en formato de 12 horas sin cero inicial;
- hh – las horas en formato de 12 horas con cero inicial;
- H – las horas en formato de 24 horas sin cero inicial;
- HH – las horas en formato de 24 horas con cero inicial;
- m – minutos sin cero inicial;
- mm – minutos con cero inicial;
- s – los segundos sin cero inicial;
- ss – los segundos con cero inicial;
- tt – visualización AM/PM (válido solo para los idiomas de configuración que admiten el formato de 12 horas para mostrar la hora).
- Nota. *) Este parámetro no se aplica a los campos de entrada de fecha.
- DLF – el formato de fecha local. Especifique el formato de las partes de la fecha.
- D – fecha (en dígitos);
- DD – fecha completa (nombre completo del mes);
- T – hora completa, la fecha se puede combinar con la hora,
- DT – fecha y hora.
- Ejemplo: Formato(‘20051120140323’,”DLF=DDT”) = “domingo, 20 de noviembre de 2005 14:03:23”.
- ¡Atención! El orden de las opciones de cadena de formato para DLF <fecha+hora> (DT o DDT) no se puede cambiar.
- DE – la presentación de cadena de una fecha en blanco. Ejemplo: Formato(‘00010101000000’ ,”DE=””fecha en blanco”””) muestra “fecha en blanco”.
- BF – la presentación de cadena de Falso lógico.
- BT – la presentación de cadena de Verdadero lógico.
- NF – la plantilla de formato de número. Puede incluir el parámetro N que especifica la posición del número. El formato del número está definido por los demás parámetros de la cadena de formato. Los demás caracteres se muestran “tal cual”. Los caracteres entre comillas simples o dobles se muestran “tal cual”. La plantilla de formato no se aplica al número 0 (a menos que la cadena de formato incluya “NZ=”).
Nota. Para campos de entrada de texto, el parámetro DE no es aplicable. El parámetro DLF solo se utiliza con los valores D, T y DT.
Valor devuelto:
Tipo: Cadena.
Una cadena que contiene un valor formateado.
Descripción:
Genera presentaciones de valores legibles para humanos. Esta función se recomienda para su uso en informes y en cualquier funcionalidad que muestre valores.
Disponibilidad:
Cliente ligero, cliente web, cliente móvil, servidor, cliente grueso, conexión externa, aplicación móvil (cliente), aplicación móvil (servidor), servidor independiente móvil.
Ejemplo:
| // Ejemplos de formato de número A = Format(123456.789, “ND=10; NFD=2”); // A = “123,456.79” A = Format(123456.789, “NDS=’-‘”); // A = “123,456-789” A = Format(–123456.789, “NN=0”); // A = “(123,456.789)” A = Format(123456.789, “ND=10; NFD=2; NF=”“USD N”“”); // A=”USD 123,456.79″ A = Format(100, “NF=”“$N’/hora'”“”); // A=”$100/hora” // Ejemplos de formato de fecha // Ejemplo de formato de expresión lógica |
Disponible desde:
Disponible desde la versión 8.0.
Descripción cambiada en la versión 8.3.21.
